SAR block

Short summary

Name	`SAR`
→POU type	→function
Category	Standard (non-safe), BitstringEnh
Conform to →IEC-standard	not defined in IEC-standard
Graphical interface
Available since	version 1.20.0 (for Neuron Power Engineer) – initial variant: `ANY_BIT` for input `IN` and return value version 1.23.0 (for Neuron Power Engineer) – enhancement: `ANY_INT` for input `IN` and return value version 3.8.0 (for library `Standard (non-safe)`): block moved in this library

Functionality

The block returns the result of an arithmetic shift to the right.

At input IN, enter the value to be shifted. At input N, enter the bits to right-shift the value arithmetically. The bits cleared on the left are filled with the sign bit.

Compare: "SHR block" for a logical shift to the right.

Inputs, return value

	Identifier	→Data type	Description
Inputs:	`IN`	`BOOL`, `BYTE`, `WORD`, `DWORD` or `LWORD` (corresponds to →generic data type `ANY_BIT`) and `USINT`, `UINT`, `UDINT`, `ULINT`, `SINT`, `INT`, `DINT` or `LINT` (corresponds to →generic data type `ANY_INT`)	input value
Inputs:	`N`	`SINT`	number of bits to shift
Return value:	–	`BOOL`, `BYTE`, `WORD`, `DWORD` or `LWORD` (corresponds to →generic data type `ANY_BIT`) and `USINT`, `UINT`, `UDINT`, `ULINT`, `SINT`, `INT`, `DINT` or `LINT` (corresponds to →generic data type `ANY_INT`)

Input EN and output ENO are available when →calling the block. See "Execution control: EN, ENO" for information on input EN and output ENO.

See:

"Blocks for safe logic" whether this block is supported for developing safety-relevant applications.
"Highlighting safe logic in the FBD-editor" for the effects when using the block as a block for safe logic.

Example for usage within ST-editor

PROGRAM Test

VAR

        result : BYTE;

    END_VAR

    result := SAR(IN := 16#40, N := 1);       (* The variable 'result' evaluates to '16#20'. *)

    result := SAR(IN := 16#80, N := 1);       (* The variable 'result' evaluates to '16#C0'. *)

END_PROGRAM

When creating your application within the ST-editor, enter a call of a block by typing the text as requested by the syntax or use Content Assist.